Bring docs in shape

svn path=/trunk/; revision=17935

diff --git a/ChangeLog b/ChangeLog
index d835a8cf2c3bae3f3b5954540a89db97aceb1b90..2328716ee335ec7bd3a3fec782de209e18e304c4 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,6 @@
 2007-05-26  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkscalebutton.c:
        * gtk/gtkrecentaction.c:
        * gtk/gtkrange.c:
        * gtk/gtkprinter.c:

diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am
index 19f6adf676daad22e0673b91258951008d853022..79fdf292c619e866cc455621564903ed444879aa 100644 (file)
--- a/docs/reference/gtk/Makefile.am
+++ b/docs/reference/gtk/Makefile.am
@@ -88,7 +88,6 @@ IGNORE_HFILES=                                \
        gtktreeprivate.h                \
        gtktypebuiltins.h               \
        gtkxembed.h                     \
-       gtkwindow-decorate.h            \
        gtkwin32embed.h                 \
        gtkwin32embedwidget.h           \
        xdgmime                         \

diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt
index 17d9192cf1a114e2c7a35630a112f9d1e6ed0556..8dcfd7a04c13ec6cd2a2189a5576fa6d3400bf8c 100644 (file)
--- a/docs/reference/gtk/gtk-sections.txt
+++ b/docs/reference/gtk/gtk-sections.txt
@@ -472,43 +472,6 @@ GTK_BUTTON_GET_CLASS
 gtk_button_get_type
 </SECTION>
 
-<SECTION>
-<FILE>gtkscalebutton</FILE>
-<TITLE>GtkScaleButton</TITLE>
-GtkScaleButton
-gtk_scale_button_new
-gtk_scale_button_set_icons
-gtk_scale_button_get_value
-gtk_scale_button_get_adjustment
-gtk_scale_button_set_adjustment
-<SUBSECTION Standard>
-GTK_TYPE_SCALE_BUTTON
-GTK_SCALE_BUTTON
-GTK_IS_SCALE_BUTTON
-GTK_SCALE_BUTTON_CLASS
-GTK_IS_SCALE_BUTTON_CLASS
-GTK_SCALE_BUTTON_GET_CLASS
-<SUBSECTION Private>
-gtk_scale_button_get_type
-GtkScaleButtonPrivate
-</SECTION>
-
-<SECTION>
-<FILE>gtkvolumebutton</FILE>
-<TITLE>GtkVolumeButton</TITLE>
-GtkVolumeButton
-gtk_volume_button_new
-<SUBSECTION Standard>
-GTK_VOLUME_BUTTON
-GTK_TYPE_VOLUME_BUTTON
-GTK_IS_VOLUME_BUTTON
-GTK_VOLUME_BUTTON_CLASS
-GTK_IS_VOLUME_BUTTON_CLASS
-GTK_VOLUME_BUTTON_GET_CLASS
-<SUBSECTION Private>
-gtk_volume_button_get_type
-</SECTION>
-
 <SECTION>
 <FILE>gtkcalendar</FILE>
 <TITLE>GtkCalendar</TITLE>
@@ -3091,8 +3054,10 @@ gtk_scale_button_get_adjustment
 gtk_scale_button_get_value
 <SUBSECTION Standard>
 GTK_SCALE_BUTTON
-GTK_SCALE_IS_BUTTON
+GTK_IS_SCALE_BUTTON
 GTK_TYPE_SCALE_BUTTON
+GTK_SCALE_BUTTON_CLASS
+GTK_IS_SCALE_BUTTON_CLASS
 GTK_SCALE_BUTTON_GET_CLASS
 <SUBSECTION Private>
 gtk_scale_button_get_type
@@ -3809,8 +3774,6 @@ GTK_TEXT_CHILD_ANCHOR_GET_CLASS
 gtk_text_view_get_type
 gtk_text_child_anchor_get_type
 GtkTextBTree
-GtkTextChildBody
-GtkTextPixbuf
 GtkTextWindow
 GtkTextPendingScroll
 </SECTION>
@@ -4137,11 +4100,6 @@ gtk_tooltip_set_icon
 gtk_tooltip_set_icon_from_stock
 gtk_tooltip_set_custom
 gtk_tooltip_trigger_tooltip_query
-gtk_tooltip_focus_in
-gtk_tooltip_focus_out
-gtk_tooltip_toggle_keyboard_mode
-gtk_tooltip_handle_event
-gtk_tooltip_hide
 <SUBSECTION Standard>
 GTK_TYPE_TOOLTIP
 <SUBSECTION Private>
@@ -4648,8 +4606,6 @@ gtk_tree_view_get_type
 <FILE>gtkcellview</FILE>
 <TITLE>GtkCellView</TITLE>
 GtkCellView
-gtk_cell_view_get_use_fg
-gtk_cell_view_set_use_fg
 gtk_cell_view_new
 gtk_cell_view_new_with_text
 gtk_cell_view_new_with_markup
@@ -4964,6 +4920,8 @@ gtk_volume_button_new
 GTK_VOLUME_BUTTON
 GTK_IS_VOLUME_BUTTON
 GTK_TYPE_VOLUME_BUTTON
+GTK_VOLUME_BUTTON_CLASS
+GTK_IS_VOLUME_BUTTON_CLASS
 GTK_VOLUME_BUTTON_GET_CLASS
 <SUBSECTION Private>
 gtk_volume_button_get_type

diff --git a/gtk/gtkscalebutton.c b/gtk/gtkscalebutton.c
index 822913e1a1acc0d29dcacf924f18af904c33583c..6f38b5d5bc421090ecf4bbfd24d6f9036a6039b8 100644 (file)
--- a/gtk/gtkscalebutton.c
+++ b/gtk/gtkscalebutton.c
@@ -408,16 +408,15 @@ gtk_scale_button_dispose (GObject *object)
 /**
  * gtk_scale_button_new
  * @size: a stock icon size
- * @lower: the minimum value of the scale (usually 0)
- * @upper: the maximum value of the scale (usually 100)
- * @step_increment: the stepping of value when a scroll-wheel event,
- * or up/down arrow event occurs (usually 2)
+ * @min: the minimum value of the scale (usually 0)
+ * @max: the maximum value of the scale (usually 100)
+ * @step: the stepping of value when a scroll-wheel event,
+ *        or up/down arrow event occurs (usually 2)
  * @icons: a %NULL-terminated array of icon names, or %NULL if
- * you want to set the list later with gtk_scale_button_set_icons(). See
- * gtk_scale_button_set_icons() for details.
+ *         you want to set the list later with gtk_scale_button_set_icons()
  *
- * Creates a #GtkScaleButton, with a range between lower and upper, with
- * a stepping of step_increment.
+ * Creates a #GtkScaleButton, with a range between @min and @max, with
+ * a stepping of @step.
  *
  * Return value: a new #GtkScaleButton
  *
@@ -425,9 +424,9 @@ gtk_scale_button_dispose (GObject *object)
  */
 GtkWidget *
 gtk_scale_button_new (GtkIconSize   size,
-                     gdouble       lower,
-                     gdouble       upper,
-                     gdouble       step_increment,
+                     gdouble       min,
+                     gdouble       max,
+                     gdouble       step,
                      const gchar **icons)
 {
   GtkScaleButton *button;
@@ -439,10 +438,8 @@ gtk_scale_button_new (GtkIconSize   size,
   if (icons != NULL)
     gtk_scale_button_set_icons (button, icons);
 
-  gtk_range_set_range (GTK_RANGE (priv->scale), lower, upper);
-  gtk_range_set_increments (GTK_RANGE (priv->scale),
-                           step_increment,
-                           10 * step_increment);
+  gtk_range_set_range (GTK_RANGE (priv->scale), min, max);
+  gtk_range_set_increments (GTK_RANGE (priv->scale), step, 10 * step);
 
   if (priv->size != size)
     {
@@ -541,6 +538,8 @@ gtk_scale_button_set_icons (GtkScaleButton  *button,
  * Gets the #GtkAdjustment associated with the #GtkScaleButton's scale.
  * See gtk_range_get_adjustment() for details.
  *
+ * Returns: the adjustment associated with the scale
+ *
  * Since: 2.12
  */
 GtkAdjustment*